----------------------  RESTORE - External DOS Command  ------------------------

RESTORE restores one or more files that were backed up with the BACKUP command
   from diskettes to a fixed disk.

FORMAT:   RESTORE d1: [d2:][path][filename[.ext]][/S][/P]

REMARKS:

   d1:      - the drive that will contain the backup diskette(s).
   d2:      - the fixed disk drive to which files will be restored.  If omitted,
              the default drive is assumed.
   path     - the directory path of the directory that will receive the
              restored files.  If omitted, the current directory is assumed.
   filename - the name of the file to be restored.  Global characters (* and ?)
              are allowed.
   .ext     - the filename extension of the file to be restored.  Global
              characters (* and ?) are allowed.
   /S       - specifies that files in the current directory and all other
              subdirectories beyond it are to be restored.
   /P       - prompts to ask if a file that has been changed since the last
              backup or if a file designated "read only" should be restored.
              You can then choose whether or not to restore the file.  Read-only
              is a file attribute that can be set by programs interfacing
              internally with DOS.  The hidden DOS system files are read-only.

   If filename and extension are omitted, then all files backed up from the
   directory are restored.

   If you use global characters (* and ?) in the filename or extension, you will
   be prompted to insert the next diskette after the files have been restored.

   Only files that have been backed up with the BACKUP command may be restored.
   As RESTORE executes, you will be prompted to insert the backup diskettes in
   order.  If you use /S to restore to a subdirectory and the subdirectory is
   missing on the fixed disk, RESTORE will create it and restore the files.

   RESTORE sets the ERRORLEVEL variable (which can be tested in a batch file
   with the Batch Subcommand IF) to one of the following:

      0 = normal completion           3 = terminated by user (Control-Break)
      1 = no files found to restore   4 = terminated due to error


WARNING:  When a file is restored to a directory that contains a file with the
   same name, the contents of the existing file are replaced by the restored
   file.


EXAMPLES:

Restore all files from diskette in drive A to fixed disk drive C:

          RESTORE A: C:\ /S


Restore file MYFILE from diskette in drive A to fixed disk drive C.  The file is
to be restored to the BUDGET directory.  BUDGET is a subdirectory of the root
directory:

          RESTORE A: C:\BUDGET\MYFILE


Restore all files from diskette in drive A to the BUDGET subdirectory on fixed
disk drive C.  BUDGET is a subdirectory of the root directory:

          RESTORE A: C:\BUDGET


Restore all files from diskette in drive A to fixed disk drive C that have the
filename extension of .DAT.  Restore these files to the current directory:

          RESTORE A: C:*.DAT
